Carrossel

O Bloco de "Carrossel" do Digital Contact Bots permite exibir conteúdos em formato de carrossel deslizável, com até 15 cards por bloco. Esse recurso é útil para apresentar produtos, serviços ou opções interativas ao usuário.

Configurações do bloco "Carrossel" no Digital Contact Bots

O Bloco de "Carrossel" pode ser encontrado no menu lateral, dentro da seção “Texto e Menu”.

Ao ser inserido no fluxo, ele aparecerá assim:

Após ser configurado, o bloco assume a seguinte aparência:

O menu lateral do Bloco de Carrossel contém os seguintes campos:

Ao expandir a opção de ação, serão exibidos os botões.

Título do Carrossel: texto exibido acima dos cards no WhatsApp. Pode ter até 1.024 caracteres. Para outros canais esse campo é ignorado. Caso o campo seja deixado em branco em um bot com canal WhatsApp, o sistema utiliza o título do próprio bloco como fallback; se o título do bloco também estiver vazio, um ponto (.) é enviado automaticamente para satisfazer o requisito da API.

Cada carrossel pode conter até 15 cards, e cada card inclui:

• Imagem: suporta arquivos de até 15 MB. Pode ser adicionada arrastando o arquivo ou selecionando através do botão.
• Título: limite de 13 caracteres na exibição (caso ultrapasse, será exibido com reticências “…”). Para o WhatsApp, o título é inserido no corpo do card junto com a descrição — veja detalhes na seção Comportamento no WhatsApp.
• Descrição: limite de 600 caracteres. Para o WhatsApp, o total de Título + Descrição deve respeitar o limite — veja detalhes na seção Comportamento no WhatsApp.
• Botões: até 4 botões por card. Cada botão pode conter até 20 caracteres. Os botões podem ser configurados com os seguintes destinos:
  • 1. URL: limitado a 200 caracteres.
  • 2. Telefone: composto pelo DDD e número
  • 3. Bloco: permite direcionar o usuário para outro bloco do fluxo.
  • 4. Copiar: permite que o usuário copie um texto ou o conteúdo de uma variável.

Após configurar o fluxo, a exibição fica assim:

Para configurar um botão:

1. clique no botão desejado.
2. edite o nome e defina o destino (URL, telefone, bloco ou copiar).

O nome do botão e o destino configurado aparecem ao lado de “Destino >”, facilitando a identificação:

Para adicionar um novo card, clique no botão ”+” ao lado da imagem:

Quando há mais de um card, o botão de excluir card fica disponível, permitindo remover um item caso necessário:

A navegação entre os cards pode ser feita através das setas laterais:

Após as configurações, é assim que o carrossel se parecerá no WebChat e no WhatsApp:

---

Comportamento no WhatsApp

O bloco de Carrossel funciona no canal WhatsApp exclusivamente com o provedor Sendfy Cloud. Abaixo estão as regras e limitações específicas desse canal.

Título do Carrossel

No WhatsApp, o campo Título do Carrossel é obrigatório, ele corresponde ao texto da mensagem principal exibida acima dos cards. Configure-o no campo "Título do Carrossel" no painel do bloco.

Caso o campo seja deixado em branco, o sistema aplica o seguinte fallback em ordem: Usa o título do bloco (campo "Título" no cabeçalho do bloco no builder), se preenchido. Se o título do bloco também estiver vazio, envia um ponto (.) automaticamente.

Número de cards

O WhatsApp exige no mínimo 2 e no máximo 10 cards por carrossel (limitação da Meta). Se o bloco tiver fora desse intervalo, o carrossel não será enviado.

Consistência de botões entre cards

Todos os cards do carrossel devem ter o mesmo tipo e a mesma quantidade de botões. Caso haja inconsistência, o carrossel é bloqueado e a conversa é encerrada automaticamente. O builder exibe um aviso quando o bot possui o canal WhatsApp configurado.

Tipos de botão suportados no WhatsApp

No WhatsApp, apenas dois tipos de destino de botão funcionam:

Tipo no builder	Como é enviado ao WhatsApp	Observação
URL	cta_url	Somente 1 botão URL por card (os demais são ignorados); rótulo: máx. 20 caracteres
Bloco	quick_reply	Múltiplos botões permitidos; rótulo: máx. 20 caracteres

Todos os cards devem usar o mesmo tipo de botão (todos URL ou todos Bloco).

Título e Descrição do card no WhatsApp

A soma de Título + Descrição do card deve ter no máximo 160 caracteres no total (limitação da Meta). Conteúdo que ultrapassar esse limite será truncado na entrega.

Regras para execução do Escape configurado no bloco.

• Quando houver apenas UM CARD.
• Quando houver MAIS de 10 CARDS.
• Quando QUALQUER Card tiver botões de tipo diferentes, ou seja todos os botões tem que ser do mesmo tipo do botão do primeiro card.
• Quando tiver cards com números DIFERENTES de botões.